Aminet 1 (Walnut Creek)/Aminet - June 1993 [Walnut Creek].iso/ab20/sounds/tools/oscilscp.lzh/osc.man

Internet Message Format | 1991-12-07 | 7KB

From [e-mail] Tue Dec  3 13:08:00 1991
Received: from zeus.cs.umu.se by sunic.sunet.se (5.61+IDA/KTH/LTH/1.11)
    id AAsunic29655; Tue, 3 Dec 91 12:21:11 +0100
Received: by zeus.cs.umu.se (5.61+IDA/KTH/LTH/91-02-01) id AAzeus20029; Tue, 3 Dec 91 12:21:07 +0100
Return-Path: <[e-mail]>
From: [e-mail]
Message-Id: <[e-mail]>
Subject: Re: Oscilloscope !
To: [e-mail] (Esa Haapaniemi)
Date: Tue, 3 Dec 91 12:21:05 GMT
In-Reply-To: <[e-mail] .oulu.fi>; from "Esa Haapaniemi" at Nov 28, 91 2:57 pm
X-Mailer: ELM [version 2.3 PL11]
Status: OR

Ok, Esa here it is!
You'll get the executable in another mail!



/Joakim Rosqvist     ($DR.HEX$)   Email to: [e-mail]
----------------------------------



               Manual for Osc, written 14/10 1991.
    ----------------------------------------------------------

Osc is a real-time digital oscilloscope to be used with a mono
8-bit sampler connected to the parallel port.

Osc can be started from CLI or WB. No parameters.
It should work with A500/1000/2000/3000.
Preferably in PAL-mode since it needs 256 scanlines to display all 8 bits
of a waveform.
Features include scanning, trigging, time-measuring and a signal generator.


NORMAL SCAN MODE
=========================
When started, the program will automatically start scanning at ~32000 Hz.
Now, you can press F1-F10, DEL or HELP to set another sampling frequency.

F1=1 kHz   F2=2 kHz   F3=3 kHz   F4=4 kHz   F5=5 kHz
F6=8 kHz   F7=11 kHz  F8=16 kHz  F9=22 kHz  F10=29 kHz
DEL=44 kHz (maximum)  HELP=32 kHz (can be altered).

You can also press the right mousebutton to freeze the curve (Checked
before each sweep) The program will connect the dots to form a curve.
Releasing the button will restart the sweep.


TRIGG SELECT
=================
There is also an option to trigg the curve, (=only allow the sweep to
start at a certain position and moving in a certain direction).
First select the direction with up-arrow or down-arrow. The curve will
freeze immediately and you will get a small horizontal line at the left
edge of the screen. Move this up or down with the mouse to the desired
trigger position and press left mousebutton to restart the sweep.

To exit the trigger setting module without setting any position or to
return the oscilloscope to "free run" again, press space.


TIME/FREQUENCY MEASURING
=============================
Freeze the curve with the right button and while holding it down, press
the left button as well, then release both buttons.
You are now in time/frequency measuring mode. The curve will dim and
two orange vertical lines will appear. Move the right one with left-arrow/
right-arrow and the left one with ">" and "<" (The "." and "," keys)
The program will tell you the time passed between the two marks
in microseconds, milliseconds or seconds, as aproppriate.
It will also consider what you have marked as one cycle of a waveform and
print it's frequency.
You can exit the time/frequency measuring mode with left mousebutton,
space, escape, TAB or tilde (~).


SIGNAL GENERATOR
=====================
The signal generator is entered by pressing TAB or tilde while in normal
scanning mode. Some text will appear in front of the curve, which will
dim, but continue scanning. You can now walk around the screen with the
arrowkeys. A waveform or a number will be inverted to indicate the position.
There will be two identical sets of four waveforms (sinus, triangle,
squarewave and sawtooth) and two numerical values for frequency and volume.

At the bottom of the screen, 11 values are printed. This is the sampling-
frequencies, in kHz that the program will use if you press the keys F1-F10
or DEL. Those keys can be used from within signal generator mode as well.
Just above that line stands a single number. This is the frequency used
when you press the HELP-key. It can be defined to whatever you want in
the range 28 Hz - 44 kHz. Just press down-arrow until the number is
inverted and enter the new value. The first digit you press will erase
the current number and leave only the digit you typed. There will be
no visible cursor. Backspace can be used to correct mistakes.
When finished editing the new value, press return or any arrowkey to
let the program use your new value. It will be checked against the valid
ranges and converted to the closest avaliable value.
The program will always use the Help key's frequency after it has been
edited regardless of which it used before.

One of the waveforms on each of the two voices will have a frame around
it to indicate that this is the selected waveform for this voice.
Change this by pressing return while positioned over the desired waveform.

The volume and frequency are changed just like the help-frequency.
A frequency of 0 Hz will turn sound DMA off for that voice.
The combined sound of the two voices will be sent to the right sound
output of your Amiga. Please note that all waveforms can't be set to a
frequency with the same accurracy, if you specify a 100 Hz sinuswave and
a 100 Hz trianglewave they will not be completely syncronized.
The squarewave has the highest accurracy.

100 Hz sinus    will be output as 100.23346 Hz
100 Hz triangle will be output as  99.87549 Hz
100 Hz sawtooth will be output as  99.87549 Hz
100 Hz square   will be output as  99.99825 Hz

If you specify the same waveform and frequency for both voices, perhaps
to get a higher output volume, press "S" for "Sync". This will turn both
voices off and then restart them at the same time. Otherwise they will
be in random phase with each other. You can press return on the
waveform several times to re-generate the sound and get another phase
difference.

Sometimes the waveform will fly very quickly over the display and is
very difficult to examine. To avoid this you can temporarily exit the
signal generator with TAB, tilde or escape, set a trigger position and
get back again. Better, perhaps, is to make a "faked" trigg by pressing "T".
This will alter the help-frequency to 320 times the latest specified
frequency, to ideally have one cycle of the waveform over the display.
(It usually drifts somewhat). If 320 times your frequency is too high,
the program will half that value until it gets into the allowed range.
This means you might get 2, 4, 8 etc cycles on the screen.

Of course, the curve can be halted with the right mousebutton even in
signal generator mode. If you press both mousebuttons you will not get
into time measuring mode, instead the curve just stops there with no
need to hold down a mouse button. It can be restarted with left mousebutton
or space. If you exit the signal generator with the curve frozen it will
immediately get into time-measuring mode.


AFTERWORDS
==============

This program is shareware, it may be copied freely provided this
document file follows it. If you find this program useful I would
apperciate if you sent the equivalent of $15 in your currency to
account #691023-0075 at Nordbanken, SWEDEN.

Thanks to Arvid Svderberg and Lars Eriksson [Zion] for ideas
to improvements.

My Email address:  [e-mail]

Snail:   Joakim Rosqvist
         Stipendiegrdnd 10B-112
         S-90735 Umee
         SWEDEN

         Phone [phone]

Hope you enjoy this                         /$DR.HEX$